Skunkware 5/Skunkware 5.iso/tls/tls036.1.Z/tls036.1/usr/man/cat.SMT/docut.SMT.z/docut.SMT

Text File | 1992-09-15 | 6.7 KB | 181 lines

 docut(SMT)                           .                            docut(SMT)



 _N_a_m_e

    docut - create an application distribution

 _S_y_n_t_a_x

    ddooccuutt  [--cc] [--SS] [--ee_ffff_llll_aaaa_gggg] [--ii] [--ss] [--uu] [--ff _vvvv_aaaa_rrrr_ssss______ffff_iiii_llll_eeee] [--pp _pppp_kkkk_gggg_dddd_iiii_rrrr] [--oo
    _mmmm_kkkk_pppp_eeee_rrrr_mmmm______oooo_uuuu_tttt_ffff_iiii_llll_eeee] [--OO _mmmm_kkkk_pppp_eeee_rrrr_mmmm______dddd_iiii_ssss_tttt_dddd_iiii_rrrr] [--DD _mmmm_kkkk_pppp_eeee_rrrr_mmmm______dddd_iiii_rrrr_ffff_iiii_llll_eeee]

 _O_p_t_i_o_n_s


    --cc       compresses the files in the distribution.  ddooccuutt also passes
             this option to mmkkccuuttss.

    --CC       disables check for symbolic links

    --ee       erases files specified by _ffff_llll_aaaa_gggg. _ffff_llll_aaaa_gggg is a combination of any of
             the following:

             aa    erases administrative files such as images and sums files

             cc    erases the CCDDIISSTT directory, which contains compressed dis-
                  tribution files

             dd    erases the _d_i_s_t directory, which contains the uncompressed
                  distribution files

             pp    erases the _m_i_s_c directory, which contains package descrip-
                  tions previously entered (with the --pp option) and starts
                  from scratch

    --ff       specifies a file that ddooccuutt sources to set the required environ-
             ment variables.  If the --ff option is not given, docut tries to
             source the file ./_s_i_t_e__v_a_r_i_a_b_l_e_s by default.

    --pp       cuts a distribution that is in multiple packages.  It is
             included for backwards compatibility with the Product Engineer-
             ing Toolkit (PET).

    --SS       distribution contains files to be serialized

    --oo, --OO, --DD
             options that ddooccuutt passes to mmkkppeerrmm.  For details on these
             options, see the mmkkppeerrmm(SMT) manual page.

    --ii, --ss   options that ddooccuutt passes to mmkkccuuttss.  For details, see the
             mmkkccuuttss(SMT) manual page.

    --uu       display command line usage, then quit


 _D_e_s_c_r_i_p_t_i_o_n

    The ddooccuutt utility provides an interactive method of cutting an applica-
    tion distribution. ddooccuutt first reads information about the product from
    the file specified with the --ff option (or from the default file,
    ./_s_i_t_e__v_a_r_i_a_b_l_e_s).  It uses mmkkppeerrmm(SMT) to create a permlist for the
    product, and constructs a distribution tree containing all the files in
    the product.  It then uses mmkkccuuttss(SMT) to transfer the distribution tree
    to the media, compressing the files if requested (with the --cc option).

    A simple use of ddooccuutt is as follows:  Copy all distribution files with
    the ttaarr(C) utility into a new directory, for example, one named ./_s_o_u_r_c_e.
    (The ./_m_i_s_c, ./_d_i_s_t and ./_c_d_i_s_t directories are reserved names that can-
    not be used.)

    Copy the file /_u_s_r/_l_i_b/_s_c_o_s_m_t/_s_i_t_e__v_a_r_i_a_b_l_e_s into the current directory.
    Edit it to set the variables in it to the correct values for your prod-
    uct.  If you rename this file, use the --ff option to give ddooccuutt its name.
    The following values are required.

    PPRROODDPPRRDD          _pppp_rrrr_dddd code for the product (_pppp_rrrr_dddd= field in permlist)

    PPRROODDSSEETT          full name of the product (_ssss_eeee_tttt= field in permlist)

    PPRROODDTTYYPP          system type of product (_tttt_yyyy_pppp= field in permlist)

    PPRROODDRREELL          release number of product (_rrrr_eeee_llll= field in permlist)

    BBAASSEEPPAACCKKDDIIRR      directory under which the product's files are located,
                     for example, ./_s_o_u_r_c_e above

    BBAASSEEPPAACCKKNNAAMMEE     name of the main package in the product

    BBAASSEEPPAACCKKDDEESSCC     short description of the package

    DDEEVVIICCEE           device name for archiving distribution

    FFOORRMMAATT           complete command needed to format a volume

    VVOOLLSSIIZZEE          size of each distribution volume

    BBLLOOCCKKIINNGG         blocking factor, if required

    Execute ddooccuutt.  First, ddooccuutt invokes mmkkppeerrmm.  If the defaults are used, a
    permlist is created in ./_d_i_s_t/_t_m_p/_p_e_r_m_s and an image of your distribution
    hierarchy is created using links to the ./_d_i_s_t directory.

    Next, ddooccuutt invokes mmkkccuuttss on the ./_d_i_s_t hierarchy to allocate files to
    volumes and to transfer the product files to the distribution media.  If
    you wish to inspect or edit the permlist, selecting Abort when prompted
    to insert the media will exit without writing to the media; selecting
    Continue will proceed to write out the product to the media.

    If you selected Abort, either ddooccuutt or mmkkccuuttss may be invoked again to
    complete cutting the product once you have finished making any changes to
    the permlist.

    The --cc flag is passed to mkcuts, which then creates a compressed hierar-
    chy ./_c_d_i_s_t from which the distribution is cut.  (Note that the ./_d_i_s_t
    directory is still created and used as an intermediate step in this pro-
    cess.)  The variable NNOOCCOOMMPPRREESSSS in the variables file may be set to list
    packages that are not to have their files compressed.  If NNOOCCOOMMPPRREESSSS is
    blank or unset, the default action of the --cc option is to compress all
    files in the product except the permlist.

 _F_i_l_e_s


    /_u_s_r/_b_i_n/_m_k_p_e_r_m
    ./_m_i_s_c/_p_k_g._d_a_t_a
    ./_m_i_s_c/_p_a_r_t_p_e_r_m_s
    ./_m_i_s_c/_e_x_t_r_a_f_i_l_e_s


 _S_e_e _a_l_s_o

    ffiixxppeerrmm(ADM), mmkkccuuttss(SMT), mmkkppeerrmm(SMT), ttaarr(C)